home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 June / EnigmA AMIGA RUN 19 (1997)(G.R. Edizioni)(IT)[!][issue 1997-06][EAR-CD III].iso / imagestudio / imagestudio68000 / docs / png_io_readme.txt < prev    next >
Text File  |  1995-06-07  |  3KB  |  126 lines
  1. README.txt
  2. ~~~~~~~~~~
  3.  
  4. Introduction
  5. ------------
  6.     Welcome to the ImageStudio PNG IO module. This module is
  7.     currently the working version of the PNG module and is still
  8.     not completely finished. It will not be fully complete until
  9.     the PNG library, on which it is based, reaches v1.0. The
  10.     current version is v0.6. This module should therefore be
  11.     considered as "work in progress".
  12.  
  13. How to
  14. ------
  15.     To install this module into ImageStudio 2.1.x, simply copy
  16.     either 'PNG000.isio' or 'PNG020.isio' into the ImageStudio
  17.     Modules/IO directory and restart ImageStudio. The '000'
  18.     version should be used on Amigas with a 68000 processor, the
  19.     '020' version can be used with 68020 and above.
  20.  
  21. Disclaimer
  22. ----------
  23.     The authors are not responsible for any damage done or loss of
  24. data caused by using this module.
  25.  
  26. Copyright
  27. ---------
  28.     This package is freely distributable.
  29.  
  30.     All parts of this package are Copyright 1995 Andy Dean and
  31.     Graham Dean.
  32.  
  33. The Authors
  34. -----------
  35.     The PNG module, and ImageStudio, is written by Andy Dean and
  36.     Graham Dean.
  37.  
  38.     The PNG library is written by Group42 and is available via
  39.     anonymous ftp at:
  40.  
  41.         ftp.uu.net /graphics/png
  42.  
  43. Graham is available at:
  44.  
  45.     14 Fielding Avenue
  46.     Poynton
  47.     Stockport
  48.     Cheshire
  49.     SK12 1YX
  50.     ENGLAND
  51.  
  52. Andy is available via Email at:
  53.  
  54.     adean@eleceng.ucl.ac.uk
  55.  
  56. Documentation
  57. -------------
  58.     This is extracted from the ImageStudio documentation:
  59.  
  60. PNG
  61. ---
  62.  
  63. Name
  64.      PNG
  65.  
  66. Load types
  67.      Colour mapped, 24, 32 and 48bits.
  68.  
  69. Save types
  70.      Colour mapped, 24bit.
  71.  
  72. Description
  73.      PNG is the license free replacement for the GIF file format.
  74.  
  75.      After the controversy with the LZW compression algorithm used in
  76.      the GIF file format, it was decided that a new standard should be
  77.      created which uses the license free LZ compression algorithm along
  78.      with many improvments over the GIF file format (e.g. support for
  79.      24bit images). PNG is that format, and supports many advanced
  80.      features to obtain the best lossless compression for any type of
  81.      bitmap image. PNG also supports features that will find themselves
  82.      useful in World Wide Web browsers, etc...
  83.  
  84.      A high degree of compatibility is obtained with our PNG
  85.      loader/saver, as it is based in part on the PNGlib code by Group42.
  86.  
  87. ARexx OPEN command ARGS
  88.      None.
  89.  
  90. ARexx SAVE command ARGS
  91.      INTERLACE,TRANSPARENCY/S,TRANSPCOLOUR/N
  92.  
  93.     INTERLACE
  94.       By default PNG files are not interlaced, however by
  95.       specifying an INTERLACE value of ADAM7 they can be saved out
  96.       with 7 levels of interlacing. This gives progressive redraw
  97.       for World Wide Web browsers.
  98.  
  99.       Note: This interlace has nothing to do with the Amiga's
  100.       interlaced screens.
  101.  
  102.     TRANSPARENCY/S
  103.       By specifying this switch, one colour out of the image's
  104.       pallete can be made `transparent', causing the background
  105.       colour to show through. This again can be useful with World
  106.       Wide Web browsers. By default, the transparent colour is
  107.       colour 0, but this can be changed (see below).
  108.  
  109.     TRANSPCOLOUR/N
  110.       This is the palette entry number that is made transparent if
  111.       the TRANSPARENT switch is used.
  112.  
  113. Example
  114.      The following saves out a standard PNG format file:
  115.  
  116.       SAVE FILE "Image.png" FORMAT "PNG"
  117.  
  118.      The following saves out a PNG file with interlace:
  119.  
  120.       SAVE FILE "Image.png" FORMAT "PNG" ARGS "INTERLACE=ADAM7"
  121.  
  122.      The following saves out a PNG file with a transparent colour of 10:
  123.  
  124.       SAVE FILE "Image.png" FORMAT "PNG",
  125.          ARGS "TRANSPARENCY TRANSPCOLOUR 10"
  126.